home *** CD-ROM | disk | FTP | other *** search
/ Alles Voor Internet / Tout Pour Internet / alles voor internet.iso / MacInternet™ / Archive-tools / Stuff and Hex ƒ / DropShell Source Notes next >
Text File  |  1992-01-25  |  3KB  |  58 lines
  1. DropShell provides a complete framework for the creation of 'DropBoxes'
  2. for System 7, thanks to Finder7's "Drag & Drop" capabilities.  
  3.  
  4. Unlike other DropBox examples, DropShell uses the CORRECT System 7 method
  5. for handling Dropboxes - Apple events!  DropShell handles all four of the
  6. required events and in turns passes the information contained therein to 
  7. your 'userProcs' which do the gory details of your dropbox.  
  8.  
  9. DropShell is also one of the first fully factored applications - meaning that
  10. any DropShell based application can be 'recorded' using an Apple event recorder,
  11. since it sends events to itself when appropriate.  It also includes a correct
  12. 'aete' resource for interaction with scripting systems.
  13.  
  14. DropShell handles a simple user interface including a splash screen, 
  15. a "Select File…" option and COMPLETE balloon help for all menus & dialogs.
  16.  
  17. Versions are provided for MPW C & Pascal as well Think C & Pascal.  We hope
  18. to provide versions in the future built around an OO framework in C++, Think C
  19. w/Objects & Object Pascal.  
  20.  
  21. For those simply interested in quickly putting together their own dropboxes, 
  22. check out DSUserProcs (.c or .p) for information about where your code goes.  
  23. You should also check out DropShell.r, even if you are not using MPW, as all 
  24. the resources are documented with comments about their use and which need to 
  25. change for your individual dropbox.
  26.  
  27. The source is well commented as to how the DropShell is organized for the
  28. curious and contains some very useful programming techniques and reusable source code.
  29.  
  30. Also included a bunch of utility routines (DSUtils) that you may find useful. 
  31. They are some useful things you may wish to do with the Process Manager, and
  32. the Apple event Manager including sending events to yourself or finding out
  33. where you are and what you name is.  
  34.  
  35. We have also provided an example DropBox - DropInfo.  DropInfo provides a function
  36. formally left to programs like DiskTop or ResEdit, that of viewing and editing a
  37. files type & creator as well as the 'Finder Flags'.  It is useful not only as 
  38. an example DropBox, but also as useful code samples for playing with the Finder
  39. Flags (especially how to get the Finder to immediately update!)
  40.  
  41. If you create any nifty DropBoxes using DropShell, we would appreciate it if you
  42. sent us copies so we can see how DropShell is being used.  Also, if you port
  43. DropShell to other development environments (Fortran, Modula-2, etc.), please 
  44. send us a copy so that we can keep an up to date set of sources.
  45.  
  46. If you have any questions, suggestions, bug reports or improvements for DropShell,
  47. please feel free to send them to either of us (both is even better ;-).
  48.  
  49.             Leonard Rosenthol                Stephan Somogyi
  50. Internet:    leonardr@ccs.itd.umich.edu        Somogyi@applelink.apple.com
  51. AOL:        MACgician                        Somogyi
  52. AppleLink:    MACgician                        Somogyi
  53.  
  54.  
  55. ----
  56. Special thanks to those who played with the early versions of the DropBoxes, 
  57. (you know who you are!) and especially those who reviewed this code & offered 
  58. suggestions for it's improvement for distribution (Marshall Clow, Greg Robbins & Dave Koziol)